home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / textps.z / textps
Encoding:
Text File  |  2002-10-03  |  9.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      TTTTEEEEXXXXTTTTPPPPSSSS((((1111))))       KKKK----SSSSppppoooooooollll bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))        TTTTEEEEXXXXTTTTPPPPSSSS((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           textps - Text to PostScript translator
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ////uuuussssrrrr////eeeettttcccc////aaaapppppppplllleeeettttaaaallllkkkk////tttteeeexxxxttttppppssss [_o_p_t_i_o_n_s]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           The _t_e_x_t_p_s filter converts text to Postscript.  It accepts
  16.           ASCII text on standard input and sends PostScript language
  17.           to standard output.  The _t_e_x_t_p_s filter passes PostScript
  18.           through without changing it.
  19.  
  20.           The _t_e_x_t_p_s filter allows page layout specification, but does
  21.           not cause the text within a page to be rearranged.  Text
  22.           extending beyond the maximum image area, however, is
  23.           truncated.  The output defaults to the _C_o_u_r_i_e_r typeface.
  24.  
  25.           K-Spool usually uses _t_e_x_t_p_s in the pipeline of the input
  26.           filter of a printer, usually _s_p_o_o_l_d_i_r/psif-_p_r_i_n_t_e_r_n_a_m_e.
  27.  
  28.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  29.           Default page layout and rows/columns are overriden by
  30.           entries from the ////eeeettttcccc////pppprrrriiiinnnnttttccccaaaapppp file (when the -_p_r_i_n_t_e_r
  31.           option is given).  The Imageable Area (which, by
  32.           implication, resets the default margins) is read from
  33.           SETUP.PPD in the current working directory.  The following
  34.           options will override those settings.
  35.  
  36.           ----ccccoooollll [[[[e]]]]_n
  37.                Set the minimum number of columns per page to _n. When
  38.                used with the eeee option, the number of columns is set to
  39.                (exactly) _n. Defaults to a minimum of 80.
  40.  
  41.           ----llll [[[[e]]]]_n
  42.                Set the minimum number of lines per page to _n. When
  43.                used with the eeee option, the number of lines is set to
  44.                (exactly) _n. Defaults to a minimum of 66.  This option
  45.                is often passed from llllpppprrrr,,,, which gets it from the _p_l
  46.                field in /etc/printcap.
  47.  
  48.           ----lllleeeennnnggggtttthhhh _n
  49.                Set the length of the physical page to _n inches.
  50.                Defaults to 8.5 inches.
  51.  
  52.           ----wwww[[[[eeee]]]] _n
  53.                Sets the number of columns in the physical page to _n.
  54.                Defaults to 80.  Often passed from llllpppprrrr,,,, which gets it
  55.                from the ppppwwww field.
  56.  
  57.           ----wwwwiiiiddddtttthhhh _n
  58.                Set the width of the page to _n inches.  Defaults to 11
  59.                inches.
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 1/20/100)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      TTTTEEEEXXXXTTTTPPPPSSSS((((1111))))       KKKK----SSSSppppoooooooollll bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))        TTTTEEEEXXXXTTTTPPPPSSSS((((1111))))
  71.  
  72.  
  73.  
  74.           ----mmmm [[[[tblr]]]]_n
  75.                Set all of the margins to _n inches.  When used with the
  76.                tttt option, only the top margin is set to _n. When used
  77.                with the bbbb option, only the bottom margin is set to _n.
  78.                When used with the llll option, only the left margin is
  79.                set to _n. When used with the rrrr option, only the right
  80.                margin is set to _n. Defaults to .25 inches for all
  81.                margins.
  82.  
  83.           ----tttt _n Set tab stops to every _n columns.  Defaults to tab
  84.                stops every 8 columns.
  85.  
  86.           ----pppp _n Set the number of pages printed on each piece of
  87.                printer paper.  Only the values 1 and 2 are accepted.
  88.                Defaults to 1 page per printer page.
  89.  
  90.           ----iiii _n Set the indent level (left shift of printout) to _n
  91.                columns.  Defaults to 0.
  92.  
  93.           ----WWWW   Set wide margin width (this is .25 inches beyond the
  94.                regular margin).
  95.  
  96.           ----cccc   Encapsulate the file, even if it is already PostScript.
  97.                Normally, PostScript files are passed through
  98.                unmodified.  This allows printing of PostScript source.
  99.                It is usually passed from llllpppprrrr when the ----llll option is
  100.                specified.
  101.  
  102.           ----dddd   Exclude the PostScript dictionary used by _t_e_x_t_p_s from
  103.                the output stream.
  104.  
  105.           ----BBBB   Print underlined text and overstrike characters in
  106.                boldface.
  107.  
  108.           ----CCCC   Print control characters in a readable format.
  109.  
  110.           ----IIII   Turn OFF using ISOLatin1Encoding in the postscript
  111.                font.
  112.  
  113.           ----PPPP   Print in portrait page layout.  This is the default.
  114.  
  115.           ----LLLL   Print in landscape page layout.
  116.  
  117.           ----nnnn _u_s_e_r
  118.                get the imageable area from the SETUP.PPD for the
  119.                specified _u_s_e_r.
  120.  
  121.           ----JJJJ _j_o_b_n_a_m_e
  122.                Set the document Title in the PostScript header to
  123.                _j_o_b_n_a_m_e.
  124.  
  125.           ----VVVV   Set verbose mode.  Print information about the page
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 1/20/100)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      TTTTEEEEXXXXTTTTPPPPSSSS((((1111))))       KKKK----SSSSppppoooooooollll bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))        TTTTEEEEXXXXTTTTPPPPSSSS((((1111))))
  137.  
  138.  
  139.  
  140.                format on standard error.  Includes Postscript commands
  141.                in the output stream to time the print job.
  142.  
  143.           ----pppprrrriiiinnnntttteeeerrrr _n_a_m_e
  144.                Read page layout parameters from the /etc/printcap file
  145.                entry for printer _n_a_m_e.  The parameters affected by
  146.                this are:  layout orientation, number of virtual pages
  147.                per printed page, exact lines per virtual page, and
  148.                exact columns per virtual page.  Specifying this option
  149.                only resets the default parameters, which will be
  150.                overriden with other command line arguments.
  151.  
  152.           ----hhhheeeellllpppp
  153.                Print the list of options to standard error.
  154.  
  155.           ----ffff _f_o_n_t-_n_a_m_e
  156.                Set the name of the regular font typeface.  Defaults to
  157.                Courier.  See CAVEATS, below.
  158.  
  159.           ----FFFF _f_o_n_t-_n_a_m_e
  160.                Set the name of the Bold font typeface.  Defaults to
  161.                Courier-Bold.  See CAVEATS, below.
  162.  
  163.      PPPPAAAAPPPPEEEERRRR SSSSIIIIZZZZEEEESSSS
  164.           If you are using paper other than letter, you will need to
  165.           adjust the width and length options to correspond to the new
  166.           size.  The following table gives the values for some common
  167.           types of paper.
  168.  
  169.                         letter    legal      A4
  170.                width     8.5       8.5       8.25
  171.                length   11.0      14.0      11.66
  172.  
  173.  
  174.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  175.           To print the file 'somefile' with wide margins.
  176.                cat somefile | textps -W | lpr
  177.  
  178.           To print the file 'somefile' on legal sized paper in
  179.           landscape layout:
  180.                cat somefile | textps -w 8.5 -l 14.0 -m 0.75 -L | lpr
  181.  
  182.  
  183.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  184.           Diagnostics and error conditions are sent to standard error.
  185.  
  186.      CCCCAAAAVVVVEEEEAAAATTTTSSSS
  187.           The _t_e_x_t_p_s filter only works with fixed width fonts.  The ----ffff
  188.           and ----FFFF options will not function correctly when a non-fixed
  189.           width font is specified.  The existence of a font is not
  190.           verified until the output is executed by a PostScript
  191.           device.  The font selection options are not listed by the
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 1/20/100)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      TTTTEEEEXXXXTTTTPPPPSSSS((((1111))))       KKKK----SSSSppppoooooooollll bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))        TTTTEEEEXXXXTTTTPPPPSSSS((((1111))))
  203.  
  204.  
  205.  
  206.           ---- ---- option.
  207.  
  208.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  209.           _p_s_f(1m)
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 1/20/100)
  262.  
  263.  
  264.  
  265.